home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-9.10-netbook-remix-PL.iso / casper / filesystem.squashfs / usr / lib / perl5 / Pango.pm < prev    next >
Encoding:
Perl POD Document  |  2009-03-17  |  4.1 KB  |  128 lines
  1. #
  2. # Copyright (C) 2003-2008 by the gtk2-perl team (see the file AUTHORS for
  3. # the full list)
  4. #
  5. # This library is free software; you can redistribute it and/or modify it under
  6. # the terms of the GNU Library General Public License as published by the Free
  7. # Software Foundation; either version 2.1 of the License, or (at your option)
  8. # any later version.
  9. #
  10. # This library is distributed in the hope that it will be useful, but WITHOUT
  11. # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  12. # FOR A PARTICULAR PURPOSE.  See the GNU Library General Public License for
  13. # more details.
  14. #
  15. # You should have received a copy of the GNU Library General Public License
  16. # along with this library; if not, write to the Free Software Foundation, Inc.,
  17. # 59 Temple Place - Suite 330, Boston, MA  02111-1307  USA.
  18. #
  19.  
  20. package Pango;
  21.  
  22. use 5.008;
  23. use strict;
  24. use warnings;
  25.  
  26. use Glib;
  27.  
  28. # if pango is at 1.10.0 or newer, we need to import the Cairo module for the
  29. # cairo glue in pango.
  30. eval "use Cairo;";
  31.  
  32. use Exporter;
  33. require DynaLoader;
  34.  
  35. our $VERSION = '1.220';
  36.  
  37. our @ISA = qw(DynaLoader Exporter);
  38.  
  39. sub dl_load_flags { $^O eq 'darwin' ? 0x00 : 0x01 }
  40.  
  41. # now load the XS code.
  42. Pango->bootstrap ($VERSION);
  43.  
  44. 1;
  45. __END__
  46. # documentation is a good thing.
  47.  
  48. =head1 NAME
  49.  
  50. Pango - Layout and render international text
  51.  
  52. =head1 SYNOPSIS
  53.  
  54.   my $surface = Cairo::ImageSurface->create ('argb32', 200, 100);
  55.   my $cr = Cairo::Context->create ($surface);
  56.  
  57.   my $layout = Pango::Cairo::create_layout ($cr);
  58.   $layout->set_text ("\x{03A0}\x{03B1}\x{03BD}\x{8A9E}");
  59.  
  60.   my $font = Pango::FontDescription->from_string ('Serif Bold 27');
  61.   $layout->set_font_description ($font);
  62.  
  63.   Pango::Cairo::show_layout($cr, $layout);
  64.  
  65.   $surface->write_to_png ('pango.png');
  66.  
  67. =head1 ABSTRACT
  68.  
  69. Pango is a library for laying out and rendering text, with an emphasis on
  70. internationalization. Pango can be used anywhere that text layout is needed,
  71. but using Pango in conjunction with L<Cairo> and/or L<Gtk2> provides a complete
  72. solution with high quality text handling and graphics rendering.
  73.  
  74. Dynamically loaded modules handle text layout for particular combinations of
  75. script and font backend. Pango provides a wide selection of modules, including
  76. modules for Hebrew, Arabic, Hangul, Thai, and a number of Indic
  77. scripts. Virtually all of the world's major scripts are supported.
  78.  
  79. In addition to the low level layout rendering routines, Pango includes
  80. L<Pango::Layout>, a high level driver for laying out entire blocks of text, and
  81. routines to assist in editing internationalized text.
  82.  
  83. [Adapted from L<http://www.pango.org/>.]
  84.  
  85. =head1 DOCUMENTATION
  86.  
  87. L<Pango> tries to stick very close in spirit to the C API of the underlying
  88. pango library.  Thus, the manual available at
  89. L<http://library.gnome.org/devel/pango/stable/> also applies to this module.
  90. Additionally, API listings in POD form are generated during compilation for
  91. each of the sub-modules.  An index of those POD pages is available at
  92. L<Pango::index>.
  93.  
  94. =head1 SEE ALSO
  95.  
  96. L<perl>, L<Glib>, L<Cairo>, L<Gtk2>.
  97.  
  98. L<Pango::index> lists the autogenerated API documentation pod files for Pango.
  99.  
  100. L<http://www.pango.org/> is the homepage of the pango C library.  Its API
  101. documentation is available at L<http://library.gnome.org/devel/pango/stable/>.
  102.  
  103. =head1 AUTHORS
  104.  
  105.  muppet <scott at asofyet dot org>
  106.  Torsten Schoenfeld <kaffeetisch at gmx dot de>
  107.  Marc Lehmann <pcg at goof dot com>
  108.  
  109. =head1 COPYRIGHT AND LICENSE
  110.  
  111. Copyright 2003-2008 by the gtk2-perl team.
  112.  
  113. This library is free software; you can redistribute it and/or modify it under
  114. the terms of the GNU Library General Public License as published by the Free
  115. Software Foundation; either version 2 of the License, or (at your option) any
  116. later version.
  117.  
  118. This library is distributed in the hope that it will be useful, but WITHOUT ANY
  119. WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
  120. PARTICULAR PURPOSE.  See the GNU Library General Public License for more
  121. details.
  122.  
  123. You should have received a copy of the GNU Library General Public License along
  124. with this library; if not, write to the Free Software Foundation, Inc., 59
  125. Temple Place - Suite 330, Boston, MA 02111-1307 USA.
  126.  
  127. =cut
  128.